home *** CD-ROM | disk | FTP | other *** search
/ PC Media 3 / PC MEDIA CD03.iso / share / udos / numday10 / numday.doc next >
Encoding:
Text File  |  1992-07-21  |  40.1 KB  |  957 lines

  1.                   NUMDAY.EXE (NUMber of DAYs between two dates and new
  2.                   date)
  3.  
  4.           version 1.0 (c) copy right 1992 All Rights Reserved
  5.           no edition date.
  6.  
  7.           Ever had a need to change the system date while you're using 
  8.           your software?
  9.  
  10.           Did you ever wonder how many days there are between now and a 
  11.           future appointment date?  And wanted to send the current date 
  12.           or the number of days between two dates to your software?
  13.  
  14.           The set up of this document is as follows:
  15.  
  16.           IN-LINE COMMAND PARAMETERS
  17.                HELP
  18.                RUNNING WITH DEFAULTS ONLY
  19.                TURNING ON/OFF NUMDAY.EXE
  20.                A NEW POP UP MENU HOT KEY
  21.                CHANGING THE POP UP MENU ATTRIBUTE (or color)
  22.                POP UP MENU'S LOCATION
  23.                DiReCtly BECOMING MEMORY RESIDENT
  24.           HOW NUMDAY.EXE WORKS
  25.                USING THE POP UP MENU
  26.           CHAT IN A HAT
  27.           PROMPTS AND MESSAGES
  28.           DISCLAIMERS, INFO FOR SYSOPS ETC
  29.  
  30.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  31.                           IN-LINE COMMAND PARAMETERS
  32.           NUMDAY parameters<ntr>            explanations
  33.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  34.                                  HELP
  35.  
  36.           If you simply type
  37.  
  38.           NUMDAY<ntr>
  39.  
  40.           then you get the help page built into this program for quick 
  41.           reference so that you can avoid reading documents such as 
  42.           this.  Typing incorrect parameters also gives you similar 
  43.           helps, but are explained in this document as well.
  44.  
  45.           It's not essential that you read this document file, because 
  46.           when you type parameters with incorrect or missing values, 
  47.           they usually give detailed context sensitive help messages 
  48.           which will substitute for this, but skimming through this 
  49.           first will help you.
  50.  
  51.           The "<ntr>" is our way of saying <CR>, ^M, ^13, <ENTER>, 
  52.           carriage return, <ENTER> etc which all mean the same thing.
  53.           We also use <bks> for backspace, <esc> for the escape key, 
  54.           and "any key" to mean any function key, cursor key, letters, 
  55.           etc etc.  There is no one key with the word "any", but if we 
  56.           say "space bar" or "space key", we mean the big long key.
  57.  
  58.           There is no <tab>, control code or extended ascii in this 
  59.           file, should you print this to paper.  There is no form feed 
  60.           here, so if you use single sheets, you must add them yourself.
  61.           If you use a daisy wheel printer without the less than sign 
  62.           "<" or the greater than sign ">", change them to the left 
  63.           parenthesis "(" and right parenthesis ")" respectively.
  64.  
  65.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  66.                           RUNNING WITH DEFAULTS ONLY
  67.  
  68.           To run this with defaults, simply type
  69.  
  70.           NUMDAY RUN<ntr>
  71.  
  72.           Just the letter "r" in "run" will work also.  There is no 
  73.           difference between the capital letters and small letters, 
  74.           unless it is specifically stated otherwise.
  75.  
  76.           Any other command or text after the Run parameter is 
  77.           ignored.  The Run parameter is used when you run 
  78.           NUMDAY.EXE without setting any other parameter or for 
  79.           commenting purpose:
  80.  
  81.           NUMDAY R anything else here becomes comments <ntr>
  82.  
  83.           The defaults used are as follows:
  84.  
  85.           1) The default hot key to pop up the Menu is the altM key
  86.              combination:  Press down on the alt key and while keeping
  87.              it pressed down, also press down on the "M" key (there is
  88.              no need to press down on the Shift or Caps Lock to make it
  89.              capital M).
  90.  
  91.           2) The character Attribute is set to value 7, which is a gray 
  92.              letter on black.  (On amber, it is light amber.  On green 
  93.              monitor, its light green etc.)
  94.  
  95.           3) The default menu will appear on the top left row and column 
  96.              respectively.
  97.  
  98.           4) The program becomes memory resident using DOS.
  99.  
  100.           If your editor or word processor lets you see the <ntr> at
  101.           the end of each line here as a music sign, ignore them.  
  102.           Sometimes, the music signs are aligned for our benefit
  103.           while this document is edited, but it is not significant.
  104.  
  105.           Often some details are reworded in a later section to help 
  106.           you grasp the meaning better.  So rapidly scan through the 
  107.           document first, before concentrating on a section which 
  108.           interests you.
  109.  
  110.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  111.                            A NEW POP UP MENU HOT KEY
  112.  
  113.           If you don't want to use the altM key combination to pop up 
  114.           the menu, then you have a choice of 100's more.
  115.  
  116.                Any key can be used as a hot key.  If you type the hot
  117.                key while in the menu, the menu aborts and the hot key
  118.                is sent to your software.
  119.  
  120.                So, if you decide to use the small letter "n" as the pop 
  121.                up menu's hot key ("M49,110"), typing it will cause the 
  122.                pop up to appear, but type the small letter (not the 
  123.                capital letter "N") again and the menu aborts, sending 
  124.                the small letter "n" to your software.
  125.  
  126.           To find what command parameter you need to make any of these 
  127.           combinations act as the new menu hot key, type
  128.  
  129.           NUMDAY M<ntr>
  130.  
  131.           This will ask you to type any valid key combination which 
  132.           can be used as a new menu hot key.  If you press down on the 
  133.           altM key combination at this time, then it responds with a
  134.  
  135.           you need
  136.           50,000
  137.  
  138.           and if you enter the command parameter
  139.  
  140.           NUMDAY M50,000<ntr>
  141.  
  142.           then altM will act as the menu's pop up hot key combination 
  143.           as is the default.
  144.  
  145.                If there is a first copy of NUMDAY.EXE already in memory, 
  146.                then this value is sent to the first copy in memory.
  147.  
  148.           If you pressed down on the alt+ combination, then it tells 
  149.           you that
  150.  
  151.           you need
  152.           131,000
  153.  
  154.           so enter this command parameter
  155.  
  156.           NUMDAY M131,000<ntr>
  157.  
  158.           to make alt+ the menu's pop up hot key.
  159.  
  160.                As you can see, to make altM, alt+, control-F1 and 
  161.                other keys into the new menu hot key, numbers are 
  162.                followed by three zeros.
  163.  
  164.           If you pressed down on the alt key and while keeping it 
  165.           pressed down, you type "22" on the numeric keypad on the 
  166.           right side of the keyboard and them let go of the alt key,
  167.           then
  168.  
  169.           NUMDAY M22<ntr>
  170.  
  171.           will make this the new hot key for the menu.
  172.  
  173.           NUMDAY.EXE ignores the comma "," and counts the number only.
  174.           The comma is only for your sake, so
  175.  
  176.           NUMDAY M131000<ntr>
  177.  
  178.           will also make alt+ the new hot key.  But
  179.  
  180.           NUMDAY M131 000<ntr>
  181.  
  182.           will not work since NUMDAY.EXE accepts the space between the
  183.           "131" and "000" as the beginning of a new command parameter.
  184.  
  185.           NUMDAY M1310,0,0<ntr>
  186.  
  187.           will work since the location and the number of commas is not
  188.           significant and is ignored anyway.  But
  189.  
  190.           NUMDAY M131.000<ntr>
  191.  
  192.           will get NUMDAY.EXE confused since it accepts the period as 
  193.           the terminator of "131" and tries to process it as a new 
  194.           command parameter which begins with ".000" and aborts.
  195.  
  196.           NUMDAY M 131,000<ntr>
  197.  
  198.           with the space between the Menu parameter and the number is
  199.           allowed because NUMDAY.EXE will search for a number as soon 
  200.           as it encounters the Menu parameter.
  201.  
  202.           NUMDAY R M22<ntr>
  203.  
  204.           will run with the default altM as the hot key because the 
  205.           Run parameter considers everything after itself as comments 
  206.           which are not checked.
  207.  
  208.           NUMDAY M1 M22<ntr>
  209.  
  210.           will tell NUMDAY.EXE to use the alt numeric keypad "1" as 
  211.           the hot key but then makes it use alt and "22" as the one to 
  212.           really use, since the later one overrides the former one.
  213.  
  214.           The internal counter can count up to approximately
  215.           4,000,000,000 but all numbers not allowed will be rejected. 
  216.           If you maliciously decide to enter large numbers, modulus 
  217.           four billion (2 to the power of 32) is used to calculate the
  218.           number.
  219.  
  220.           While the prompting parameter with
  221.  
  222.           NUMDAY M<ntr>
  223.  
  224.           only displays valid key combinations which are accepted by 
  225.           your computer, you can do
  226.  
  227.           NUMDAY M255,000<ntr>
  228.  
  229.           which causes NUMDAY.EXE to run with an impossible code
  230.           which not even 101/102 key keyboards can generate.
  231.  
  232.                After you ran this program with the hot key set to
  233.                M255,000 to prevent the pop up, if you run this program 
  234.                again with, for example,
  235.  
  236.                NUMDAY M131000<ntr>
  237.  
  238.                Then this second copy of NUMDAY.EXE will detect that a 
  239.                first copy of itself is already in memory and will not
  240.                make itself memory resident, but it also notes that
  241.                the hot key option is used.  In this case, this
  242.                NUMDAY.EXE will change the hot key of the first copy
  243.                of itself in memory to this new value (M131,000 is
  244.                alt+) so that if you now type the alt+ key
  245.                combination, the pop up menu will pop up.
  246.  
  247.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  248.                   CHANGING THE POP UP MENU ATTRIBUTE (or color)
  249.  
  250.           If you have a color monitor, or even a monochrome/amber 
  251.           monitor, you can try a pop up other than the default white 
  252.           letters on black background.  Of course, even with a paper 
  253.           white monitor, you can play with this parameter to avoid
  254.           screen burn outs.
  255.  
  256.           NUMDAY A7<ntr>
  257.  
  258.                If there is a first copy of NUMDAY.EXE already in memory, 
  259.                then this value is sent to the first copy in memory.
  260.  
  261.           This is the default which sets the menu for white letters
  262.           on black background.  Of course, on amber monitor, it
  263.           appears as amber.  On green monitors, there are only a few
  264.           useful values (A7, A112) with the rest appearing as
  265.           vertically striped characters.  On laptops, the screen
  266.           color dictates how it will appear, but your choices are
  267.           very limited, except on very expensive ones.  There is no 
  268.           trouble with palmtops, since this program's menu is a maximum 
  269.           of 32 characters long, but the following will not work 
  270.           correctly unless its screen is 80 columns wide.  Plasma, 
  271.           electroluminescent and others all behave differently, but 
  272.           mentioning all the display types and various graphic cards are 
  273.           ignored, since this isn't a dictionary on the subject.
  274.  
  275.           Rather than have you calculate the required values, just 
  276.           type
  277.  
  278.           NUMDAY A<ntr>
  279.  
  280.           without any attribute value runs the built-in interactive help,
  281.           displaying exactly how the pop up menu will look like with
  282.           different attribute values, starting with A7 default white
  283.           characters on black background.
  284.  
  285.           With the SCROLL LOCK OFF
  286.  
  287.                Press on the left/right cursors to change the value and
  288.                watch the different colors.  <esc> exits.
  289.  
  290.                Home and End keys set the attribute to A7 and A127 
  291.                respectively.  Between A128 - A255, the letters will be 
  292.                blinking.  (unless you have a Hercules Ramfont, and an 
  293.                appropriate font was loaded) If you suffer epileptic
  294.                seizures, avoid going into this area.  If you suffer
  295.                red/green color blindness, placing an appropriate
  296.                wavelength red filter over one eye will help you to
  297.                distinguish colors.  Similar for yellow/purple.
  298.  
  299.                Below A0, it becomes A255 and above A255, it becomes 
  300.                A0 again.
  301.  
  302.           With the SCROLL LOCK ON
  303.  
  304.                Press on the left/right/up/down cursors to move the 
  305.                menu around on the screen.  This leaves a mess on your 
  306.                screen, with the screen scrolling up if you move the 
  307.                menu down on the very right corner and painting your 
  308.                screen in chosen colors.  However, it gives you a rough
  309.                idea as to what row (-) or column (!) value will be 
  310.                needed to pop up the menu in a certain location.
  311.  
  312.                Home and End keys move the row value to 7 and 127
  313.                respectively.  The column values remain unaffected.
  314.  
  315.                The width of the first line is 32 characters wide, so if 
  316.                you move the menu to the very far right, the other lines, 
  317.                which are more than 32 characters will scroll to the next 
  318.                row on the left part of your screen.
  319.  
  320.                Type <esc> to exit.
  321.  
  322.                If you select, for example, blue character on red
  323.                background and paint the left bottom corner of your
  324.                screen with this color and Home to move the menu up
  325.                before exiting with <esc>, your DOS screen will be
  326.                painted in this color until you type CLS<ntr> or run
  327.                your softwares.
  328.  
  329.                On amber monitor, the DOS screen intensity is
  330.                affected.  On green monitor (with CGA card), it causes
  331.                striped illegible characters with most attribute
  332.                values.  With monochrome cards, most values produce no
  333.                change.  With Hercules Ramfont, unless you loaded the
  334.                appropriate fonts, it will behave like a regular
  335.                monochrome card.  Most laptops are CGA card
  336.                compatible, but the screen may behave as if monochrome
  337.                cards were used.  
  338.  
  339.           After you exit, the DOS screen is affected.  The original 
  340.           color and other features are not preserved.
  341.  
  342.           If you ran with the row and column values for anything but 
  343.           the default -1 and !1 respectively, then the initial menu 
  344.           location is also affected.  If you did
  345.  
  346.           NUMDAY -2 !3 A<ntr>
  347.  
  348.           the initial menu will be on second row, third column.  But 
  349.           if you did
  350.  
  351.           NUMDAY A -10 !20<ntr>
  352.  
  353.           then row and column values are set to one, not 10 and 20 
  354.           respectively, because the presence of the Attribute command 
  355.           without any command immediately goes into the interactive 
  356.           mode and ignores any other commands after it.  On the other 
  357.           hand, this works
  358.  
  359.           NUMDAY -10!20A<ntr>
  360.  
  361.           even though there are no spaces separating them.  But 
  362.           because it looks messy, you should avoid it.  If you did
  363.  
  364.           NUMDAY -100 !200 A<ntr>
  365.  
  366.           then both the row and column values are outside allowed 
  367.           values and so will abort with an appropriate message.  On 
  368.           the other hand, if you did
  369.  
  370.           NUMDAY A1 A<ntr>
  371.  
  372.           then instead of starting with the default A7, the display 
  373.           will start with A1 (blue character on black background) and 
  374.           cycle as before.  If the first attribute value is outside 
  375.           the limit of A1 - A255, this aborts with the regular error.
  376.  
  377.           If you did
  378.  
  379.           NUMDAY A5<ntr>
  380.  
  381.           you just made NUMDAY.EXE memory resident (unless NUMDAY.EXE
  382.           was already in memory) because you forgot to use the "A<ntr>" 
  383.           without any number.  The pop up will be magenta (purple) on 
  384.           black background if you have a color monitor.
  385.  
  386.           There is no compensation for VGA color table look up, 512
  387.           color EGA mode etc so that the colors mentioned above may not
  388.           apply in your case if you used a software which changes your
  389.           monitor screen colors.  IBM monitors tend to be very accurate
  390.           in actual color display, but many other monitors, including
  391.           older NEC monitors do not reproduce the specified colors
  392.           correctly so that you may have to adjust your contrast and
  393.           brightness to get almost the right colors you expected.
  394.  
  395.           The reason why this is called an Attribute, rather than a 
  396.           Color parameter is because on non-color monitors, this 
  397.           controls whether the letter is regular, high-intensity, 
  398.           reverse, blinking etc.  And none of these are in color.
  399.  
  400.                Of course, the correct spelling in Canada and Britain for
  401.                "color" is really "colour".
  402.  
  403.                "A7" does appear as true gray/grey color characters on 
  404.                black on true IBM color monitors.
  405.  
  406.           This option can be used with an amber monitor to determine 
  407.           the intensity of the letters used in the pop up menu.  The 
  408.           striation obvious with green monitors prevents most values 
  409.           from being useful.  A112 may cause a "blooming" effect on 
  410.           some lower cost monitors with inadequate power supplies.
  411.  
  412.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  413.                            POP UP MENU'S LOCATION
  414.  
  415.           The default pops up the one line menu on the top row (-1) and 
  416.           left most column (!1).  (a "row" is the line going in this "-"
  417.           direction and a "column" is the line going in this "!"
  418.           direction.)
  419.  
  420.           To change the default row to row five,
  421.  
  422.           NUMDAY -5<ntr>
  423.  
  424.                If there is a first copy of NUMDAY.EXE already in memory, 
  425.                then this value is sent to the first copy in memory.
  426.  
  427.           To change the column to column 20,
  428.  
  429.           NUMDAY !20<ntr>
  430.  
  431.                If there is a first copy of NUMDAY.EXE already in memory, 
  432.                then this value is sent to the first copy in memory.
  433.  
  434.           If your screen can display more than 80 columns wide, then 
  435.           you can change the row to 10 and the column to 80 like this
  436.  
  437.           NUMDAY -10 !80<ntr>
  438.  
  439.           The range for the row and column are -1 to -80, and !1 to 
  440.           !80 respectively.
  441.  
  442.           If you select row and column locations which are not 
  443.           supported by your monitor and video card combination, then 
  444.           the pop up menu will not be visible on screen, but is active 
  445.           nonetheless.
  446.  
  447.                The interactive mode available with the Attribute 
  448.                parameter will tell you what values will make the menu 
  449.                appear where.
  450.  
  451.           The pop up menu works on the EGA/VGA 43/50 rows mode and any
  452.           other higher mode supported by your hardware now or in the 
  453.           near future. (a "time resistant product")
  454.  
  455.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  456.                       DiReCtly BECOMING MEMORY RESIDENT
  457.  
  458.           If you find that you cannot make this pop up the menu when
  459.           you type the hot key while in DOS, then DOS (or something 
  460.           controlling DOS) prevented this from working.
  461.  
  462.           In that case, you can make this memory resident DiReCtly, 
  463.           bypassing DOS to make to this memory resident by typing
  464.  
  465.           NUMDAY DRC<ntr>
  466.  
  467.                This does not work if there is already a first copy of 
  468.                NUMDAY.EXE in memory.
  469.  
  470.           If you type
  471.  
  472.           NUMDAY R DRC<ntr>
  473.  
  474.           then since everything after the Run parameter is a comment, 
  475.           this does not make this memory resident using the DiReCt 
  476.           method.  But
  477.  
  478.           NUMDAY DRC R<ntr>
  479.  
  480.           will work, though it's the same as if you typed
  481.  
  482.           NUMDAY DRC<ntr>
  483.  
  484.           since the Run parameter is only used when the default 
  485.           parameter values are used.
  486.  
  487.           If you typed
  488.  
  489.           NUMDAY D<ntr>
  490.  
  491.           a message will display, explaining what this is used for.
  492.  
  493.           If a first copy of NUMDAY.EXE is already in memory, then this 
  494.           will tell you so.
  495.  
  496.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  497.                             HOW NUMDAY.EXE WORKS
  498.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  499.  
  500.           When you first run NUMDAY.EXE with either the default 
  501.           parameters using the Run option or others, this simply checks 
  502.           to make sure everything is in order and then becomes memory 
  503.           resident.
  504.  
  505.                This will make sure that you're using at least DOS 2.
  506.  
  507.                If the system clock date is before July of 1992, this 
  508.                aborts, since the system clock is not set correctly.
  509.  
  510.                If there is already a first copy of itself in memory, 
  511.                then this copy will check to see if it is the same 
  512.                version as this.  If not, this aborts.
  513.  
  514.           Now any parameter which you typed is checked for incorrect 
  515.           values associated with them.
  516.  
  517.                If you forgot what the parameters do, simply type
  518.  
  519.                NUMDAY<ntr>
  520.  
  521.                to display the help, then type the parameters without the 
  522.                required values to display the corresponding message, so 
  523.                that you don't have to refer back to this document.
  524.  
  525.           If there is a first copy of this in memory already, then the 
  526.           parameters are sent to the first copy and this second copy 
  527.           will abort.
  528.  
  529.           If there is no first copy of this in memory already, then this 
  530.           becomes memory resident, awaiting for you to type the hot key.
  531.  
  532.  
  533.                            USING THE POP UP MENU
  534.  
  535.           If you type the hot key by mistake, type <esc> to abort, back 
  536.           to your software.  No key will be sent to your software.
  537.  
  538.           If you typed the hot key, but want to send the hot key to your 
  539.           software, type the hot key again to abort:  The hot key will 
  540.           be sent to your software.
  541.  
  542.           Once you type the hot key the first time, the menu will look 
  543.           like this, if today is July 4, 1992:
  544.  
  545.           Jul  4,1992.... Jul  4,1992
  546.  
  547.           The current dates will be the default when this first pops up.
  548.  
  549.           Cursor left and right to move to the different month,
  550.           day-of-the-month and the year.
  551.  
  552.           Now cursor up and down to decrease and increase each value 
  553.           respectively.
  554.  
  555.                The month will decrease to "Jan" and increases up to 
  556.                "Dec".
  557.  
  558.                The day-of-the-month will decrease to "1" and increases 
  559.                up to "31".  If you set for a month which did not have 31 
  560.                days, then when you type the <space> bar, it will beep 
  561.                and places the cursor on the offending day-of-the-month.
  562.  
  563.                The year will decrease to "1980" and increases up to the 
  564.                year "2099".
  565.  
  566.           There is no need for the left or the right date to be before 
  567.           or after the other date.  The "...." will be replaced by the 
  568.           number of days between any two valid dates.
  569.  
  570.           To find the number of days between two selected dates, press 
  571.           down on the <space> key and the "...." between the two dates 
  572.           will be replaced by a number representing the number of days 
  573.           which exists between the two dates displayed.
  574.  
  575.                If one of the dates is incorrect, for example, a 
  576.                "Feb. 31", then NUMDAY.EXE will beep briefly and then 
  577.                places the blinking cursor on the incorrect 
  578.                day-of-the-month which is incorrect.
  579.  
  580.           To exit the menu using the left date on the menu as the new 
  581.           system clock date, press down on either the small or the 
  582.           capital letter "K" to Keep the date.
  583.  
  584.                If you only use this program to change the system dates,
  585.                then leave the right date as is, so that you know what
  586.                date was the true system clock date.
  587.  
  588.                If you use this program to change the system dates and 
  589.                also find the number of dates between the true date 
  590.                and the system clock dates which you change to, then 
  591.                leave the right date along and manipulate only the left 
  592.                date on the menu.
  593.  
  594.           To send the current date or both dates and the number of days 
  595.           between the two dates, type any other key. (your software must 
  596.           be in a text insertable mode)
  597.  
  598.                If you type anything but <esc>, <space> or the letter 
  599.                "K", then that is accepted as the key to send the dates 
  600.                to your software.  Lets say that you typed the small 
  601.                letter "z" to exit the menu:
  602.  
  603.                As long as you keep pressing down on the small letter 
  604.                "z", the dates are sent to your software.  Once the dates 
  605.                are sent, your software gets a lot of "zzzzz" as in
  606.  
  607.                Jul  4,1992.... Jul  4,1992zzzzz
  608.  
  609.                If your software does not use the function key F10, then 
  610.                exit with F10 and keep pressing down on F10 and after the 
  611.                dates are sent to your software, nothing happens.
  612.  
  613.                If your software beeps if you type illegal keys, you can 
  614.                use it as the key also.
  615.  
  616.           To insert only the current system clock date on the left side
  617.           on the menu, simply type any key other than the "z", "F10" etc
  618.           above and the insertion ends:
  619.  
  620.                If you used F10 to exit the menu, tap on the F10 key six 
  621.                times and then anything else and the date "Jul  4" is 
  622.                sent to your software.
  623.  
  624.           Whenever you pop up the menu, the left date is always the 
  625.           current system clock date and the right date is whatever you 
  626.           set previously.
  627.  
  628.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  629.                                CHAT in a HAT
  630.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  631.  
  632.           I've encountered lots of crooked dentists:  The main method
  633.           used was to loosen existing fillings so that they need some
  634.           new fillings.  Another was to cut the wires connecting some
  635.           false teeth so that they eventually come off.  In time, the
  636.           bad dentists move to another city to continue the practice,
  637.           but in the meanwhile the havoc creates mistrust of any good
  638.           or bad dentist.  There aren't any crooked programmer that I
  639.           know of, but crummy programmers do abound.  Think about it.
  640.           (if we're among the crummy programmers, at least we weren't
  641.           the ones who made the major softwares which destroyed those
  642.           files which took years to make but only a second to erase.)
  643.  
  644.           US and J hawks have one thing in common:  Both point out the
  645.           weaknesses in J which need fixing, so that J can efficiently
  646.           push out more US firms.  I'd rather point out the weaknesses
  647.           in "us" which need fixing, though some "US" hawks do hate me
  648.           for not down-playing its skeletons in the closet.  If you're
  649.           a devout Cuban communist, you can defeat US by helping them.
  650.           (But then who listens to a destitute igloo dweller like me?)
  651.  
  652.           A lie is simply half the truth of a coin, something the old
  653.           communists were good at.  European magazines often point to
  654.           the US which used to copy and improved upon European ideas.
  655.           US often talk of how J copy and improve upon US ideas as if
  656.           it's the whole truth, however.  No one monopolizes talents.
  657.           (actually Canadian media also chides US as a braggard worth
  658.           its weight in hot air, but then who listens to permafrosted
  659.           polar bears and mounted police in the great, frozen north?)
  660.  
  661.           Cold fusion in a bottle:  A Russian originally noted the
  662.           unusual ratios of deutrium:tritium in platinum group ore
  663.           long ago.  Then a German group claimed that they got the
  664.           fusion going before it was cast away as tritium impurity
  665.           in the metal bar.  Then two American groups claimed that
  666.           they discovered it before it too was cast away.  Now the
  667.           only major group claiming excess heat production is just
  668.           J.  If it's cast away also, will anyone get blamed?  But
  669.           if it becomes a commercial process, who'll claim credit?
  670.  
  671.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  672.                              PROMPTS AND MESSAGES
  673.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  674.  
  675.           =-=-=
  676.           Unknown parameter on the command line
  677.           =-=-=
  678.  
  679.           The parameter lists up till the one in question is displayed 
  680.           prior to this message.
  681.  
  682.           Something not recognized was found on the line when you ran 
  683.           the program.  If you ran this program from a batch file,
  684.           error messages are followed by errorlevel = 1 so that you
  685.           can have your batch file take appropriate actions.
  686.  
  687.           The list of parameters will be listed up to the erroneous 
  688.           parameter so that you know which one was incorrect.
  689.  
  690.           =-=-=
  691.           You don't have to do it, NUMDAY.EXE is already in memory
  692.           =-=-=
  693.  
  694.           You tried to run this program when a copy of this was 
  695.           already in memory.
  696.  
  697.           =-=-=
  698.           DOS 2 or above needed.
  699.           =-=-=
  700.  
  701.           You tried to use DOS 1.0 or DOS 1.1 to run this program. 
  702.           This message should not appear, since DOS 2.0 and above has 
  703.           been used for almost ten years by the time you're reading this 
  704.           document.
  705.  
  706.           =-=-=
  707.           There is a first copy of NUMDAY.EXE in memory, but the
  708.           version number is not the same as this one.  Aborting.
  709.           =-=-=
  710.  
  711.           You tried to change the settings of the first copy of 
  712.           NUMDAY.EXE in memory using the second copy running now, but 
  713.           the two were not the same version.  The second copy will abort 
  714.           without doing anything to prevent corrupting the first copy in 
  715.           memory.
  716.  
  717.           Please delete the older one and use only the newer version.
  718.  
  719.           =-=-=
  720.             Bad PC system clock year.  Since this program was made in
  721.           1992, any date prior to it indicates that the system clock
  722.           needs to be readjusted completely.  Aborting.
  723.           =-=-=
  724.  
  725.           The system clock year was set to a date before July 1992.
  726.  
  727.           Since this program was made in July of 1992, any date prior to 
  728.           that is taken as an incorrect clock value and this program 
  729.           aborts.  Please set it or you may have to replace the battery.
  730.  
  731.           =-=-=
  732.             I'm sorry.  I don't recognize this DOS version as a
  733.           type which I can work with.  Aborting.
  734.           =-=-=
  735.  
  736.           This was not DOS 1, but this DOS did not contain the 
  737.           information which is required for this to work.
  738.  
  739.           While this will work up to DOS 5.0, there is no way to say 
  740.           whether this will work with DOS 5.1 or 6.0 and other future 
  741.           versions of DOS.
  742.  
  743.  
  744.  
  745.           Note that the following messages are very explanatory and 
  746.           often require no explanation, but brief explanations are 
  747.           included since these documents often look like a dozen people 
  748.           in a dozen cities wrote separate sections. (Programmers are
  749.           often accused of writing cryptic documents:  It's because
  750.           every change in the program requires a change in the document
  751.           as well, resulting in patched up documentation.)
  752.  
  753.                The idea of using explained examples come from Digital 
  754.                Equipment Corp. manuals for the PDP/VAX minicomputers, 
  755.                but the extensive nature of error messages is our idea.
  756.  
  757.           They are listed here so that you don't have to try to
  758.           recreate all the error conditions in order to see what types
  759.           of errors are generated by this program.
  760.  
  761.           These error messages are meant to be context sensitive help 
  762.           messages so that you can avoid referring back to this 
  763.           document everytime you forgot to do something.
  764.  
  765.           =-=-=
  766.           No hot key value given.  Use
  767.           NUMDAY M<ntr>
  768.           if you need help on finding a new hot key.
  769.           =-=-=
  770.  
  771.           You only typed
  772.  
  773.           NUMDAY M0<ntr>
  774.  
  775.           which is not a valid key code.
  776.  
  777.                Actually, the control-Break key combination does generate 
  778.                this key value, but it is not accepted as valid.
  779.  
  780.           =-=-=
  781.           This is not a valid value.  For help, please use
  782.           NUMDAY M<ntr>
  783.           =-=-=
  784.  
  785.           You typed incorrect menu hot key value such as
  786.  
  787.           NUMDAY M0<ntr>
  788.           NUMDAY M260<ntr>
  789.           NUMDAY M256,257<ntr>
  790.  
  791.           If you only typed
  792.  
  793.           NUMDAY M<ntr>
  794.  
  795.           then NUMDAY.EXE will simply prompt you to type any key.
  796.  
  797.                When you type any valid key or key combination, then it
  798.                will tell you what value will be required to use this
  799.                key or key combination within the program.
  800.  
  801.           =-=-=
  802.             The Attribute parameter value is outside the correct range
  803.           A0 to A255.  To find what value is required, type
  804.           NUMDAY A<ntr>
  805.           for the interactive help to tell you what value gives what
  806.           character Attribute ("color" on a color monitor). 
  807.             To start with Attribute 17, type
  808.           NUMDAY A17 A<ntr>
  809.           Type HOME for Attribute 7, END for Attribute 127.
  810.             It also tells you what various row "-" and column "!"
  811.           values are required.
  812.           =-=-=
  813.  
  814.           You followed the Attribute followed by incorrect numbers.
  815.  
  816.           If you followed the Attribute parameter by another letter,
  817.           then it is taken as 
  818.  
  819.           NUMDAY A<ntr>
  820.  
  821.           so that if you type
  822.  
  823.           NUMDAY AB<ntr>
  824.  
  825.           the "B" is thrown away.
  826.  
  827.           =-=-=
  828.             A column is the line which goes in this "!" direction
  829.             The column "!" value is outside the correct range of
  830.           !1 through !80 to display on column 1 through column 80.
  831.             The value is not checked against the present visible
  832.           number of columns on your screen.
  833.             To find the appropriate column location for your monitor,
  834.           NUMDAY A<ntr>
  835.           which gives you the Attribute and the row/column values
  836.           and where they would appear.
  837.           =-=-=
  838.  
  839.           You typed the exclamation mark followed by nothing or a number 
  840.           outside the correct range.
  841.  
  842.           =-=-=
  843.             A row is the line which goes in this "-" direction.
  844.             The row "-" value is outside the correct range of
  845.           -1 through -80 to display on row 1 through row 80.
  846.             The value is not checked against the present visible
  847.           number of rows on your screen.
  848.             To find the appropriate row location for your monitor, try
  849.           NUMDAY A<ntr>',crlf
  850.           which gives you the Attribute and the row/column values
  851.           and where they would appear.
  852.           =-=-=
  853.  
  854.           You typed the hyphen followed by nothing or a number outside 
  855.           the correct range.
  856.  
  857.           Note that there is no difference between a minus sign "-" and 
  858.           a hyphen "-".  It's merely two says of calling the same thing.
  859.  
  860.  
  861.           =-=-=
  862.           The changes were made.  Bye.'
  863.           =-=-=
  864.  
  865.           There was a first copy of NUMDAY.EXE already in memory and you 
  866.           ran the second copy in order to change the first copy's 
  867.           parameters.  The change or changes were done and the second 
  868.           copy will exit back to the DOS prompt.
  869.  
  870.           =-=-=
  871.             I was expecting to find all three letters DRC for',crlf
  872.           DiReCtly becoming memory resident without relying on DOS.',crlf
  873.             Without this parameter, DOS help is used to become memory',crlf
  874.           resident.  Only use this parameter if this program does not',crlf
  875.           become memory resident with default.',EOT0
  876.           =-=-=
  877.  
  878.           You typed only the letter D of the DRC parameter.  Typing 
  879.           three letters prevents you from accidentally typing this when 
  880.           you meant to type something else.
  881.  
  882.           =-=-=
  883.           I first copy of NUMDAY.EXE is already in memory.',EOT0
  884.           =-=-=
  885.  
  886.           You typed
  887.  
  888.           NUMDAY DRC<ntr>
  889.  
  890.           but there was already a first copy of NUMDAY.EXE already in 
  891.           memory.
  892.  
  893.           If you cannot get the hot key to pop up the menu, then reboot 
  894.           and try again, this time without NUMDAY.EXE already in memory.
  895.  
  896.  
  897.           Hopefully all the important messages were covered.  Now for 
  898.           the information to users:
  899.  
  900.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  901.                          DISCLAIMERS, INFO FOR SYSOPS ETC
  902.           =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  903.  
  904.           All products and names mentioned are Trademarks or
  905.           Registered Trademarks of their respective corporations or
  906.           companies.  That includes my group or any other group's
  907.           programs, of course.  Some products may have patent 
  908.           protections as well.
  909.  
  910.           All enclosed programs, documents and other files are
  911.           provided AS IS, without any warranty, expressed or implied,
  912.           including but not limited to fitness for a particular
  913.           purpose.
  914.  
  915.           A contribution of $10 (Cdn$10 if you're from Canada and 
  916.           US$10 if from the US and others) is appreciated, or $20 for
  917.           an update as it becomes available.  Default diskette sent 
  918.           to you is 5-1/4" double-sided 360kb diskette unless you 
  919.           specify otherwise.  Shipping and handling are included.
  920.  
  921.                Please indicate what version and any edition date you
  922.                have:  Sometimes, the same version number & date is
  923.                kept, but the edition month/year differs.
  924.  
  925.           In hard times, anything perceived as having resell value is
  926.           a target for theft, including diskettes in nice containers:
  927.           While disk mailers cost $2+tax etc, they're easy to tamper,
  928.           as we've noticed, so if you got your diskette in cardboard,
  929.           it was for your security, not our cheapness.  But if you do
  930.           insist on a mailer, we'll comply.  (but you were warned...)
  931.  
  932.           If a shareware maker, BBS or a CD-ROM maker is mentioned as a 
  933.           source of the programs in this series, we don't even get one 
  934.           penny if you obtain the programs from them.  It's only for 
  935.           your benefit, so that you can get the programs cheaply and 
  936.           also get to know other softwares made by other people.
  937.  
  938.           NAME OF THE PROGRAM:          NUMDAY.EXE $10-$20
  939.  
  940.           PURPOSE OF THE PROGRAM:
  941.           Tells you the number of days between two dates, which can then 
  942.           be inserted to your software.  This can also correct your 
  943.           system clock with monthly adjustable value.  Also lets you 
  944.           temporarily set the system clock to another time or date and 
  945.           then get it back.  All these can be done at the DOS prompt 
  946.           level in a batch file or through the pop up menu.
  947.  
  948.           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  949.  
  950.           c/o  Dr. M. Sawada & Assoc.
  951.                P.O. Box 956       
  952.                Outremont, Quebec  
  953.                Canada  H2V 4R8    
  954.  
  955.           +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  956.  
  957.